---
    title : '通过拉伸创建几何体'
---

Three.js提供了几种方法，让我们可以从一个二维图形拉伸出三维图形。拉伸指的是沿着z轴拉伸二维图形，将它转换成三维图形。


## THREE.ExtrudeGeometry (拉伸几何体)

在这个例子中我们使用上一章的二维图片,并用THREE.ExtrudeGeometry将它转换为三位图形

import { Scene } from './05a-extrude-geometry.jsx';

<Scene />

<br/>

创建THREE.ExtrudeGeometry的代码很简单

```jsx
const data = {
    amount : 2,
    bevelThickness : 2,
    bevelSize : 0.5,
    bevelEnabled : true,
    bevelSegments : 3,
    bevelEnabled : true,
    curveSegments : 12,
    steps : 1,
};

function generateGeometry() {
    const geometry = new THREE.ExtrudeGeometry(drawShape(),data);
    geometry.applyMatrix(new THREE.Matrix4().makeTranslation(-20, -10, 0));
    updateGroupGeometry(mesh,geometry);
}
```

drawShape()函数创建一个自定义图形,然后连同options传入THREE.ExtrudeGeometry.
参数的各个选项为:

|属性|是否必需|描述|
|---|---|---|
|shapes|是|拉伸几何体需要提供一个或者多个图形(THREE.Shape对象)|
|depth|否|该属性指定图形可以拉多高(深度)|
|bevelThickness|否|该属性指定斜角的深度.斜角是前后面和拉伸之间的倒角.|
|bevelSize|否|该属性指定斜角的高度.这个高度将被加到图形的正常高度上.|
|bevelSegments|否|该属性定义斜角的分段数.分段越多,斜角越平滑.|
|bevelEnabled|否|如果这个属性设为true,就会有斜角.默认为true|
|curveSegments|否|该属性指定拉伸图形时曲线分成多少段.分段数越多,曲线越平滑.|
|steps|否|该属性指定拉伸体沿深度方向分成多少段.|
|extrudePath|否|该属性指定图形沿着什么路径(THREE.CurvePath)拉伸,没有没有指定,沿着z轴拉伸.|
|uvGenerator|否|当你给材质使用纹理时,UV映射确定纹理的哪一部分用于特定的面.使用uvGenerator属性,你可以传入自己对象,该对象将为传入的图形创建的面创建UV设置.|

## THREE.TubeGeometry (管几何体)

THREE.TubeGeometry 沿着一条三维的样条曲线拉伸出一根管.你可以通过指定一些顶点来定义路径.

import { Scene as SceneB } from './05b-extrude-tube.jsx';

<SceneB />

<br/>

我们随机的生成一些点,然后用这些点来绘制管线.创建管线的代码很简单.

```jsx
var points = [];
for (var i = 0; i < controls.numberOfPoints; i++) {
    var randomX = -20 + Math.round(Math.random() * 50);
    var randomY = -15 + Math.round(Math.random() * 40);
    var randomZ = -20 + Math.round(Math.random() * 40);

    points.push(new THREE.Vector3(randomX, randomY, randomZ));
}
// use the same points to create a convexgeometry
var tubeGeometry = new THREE.TubeGeometry(new THREE.CatmullRomCurve3(points), segments, radius, radiusSegments, closed);
```

我们首先要做的时获取一组THREE.Vector3类型的顶点,在使用这些点前转化成THREE.CatmullRomCurve3对象.
THREE.TubeGeometry还支持一些其他的参数.

|属性|是否必需|描述|
|---|---|---|
|path|是|该属性用一个THREE.SplineCurve3对象来指定管应当遵循的路径|
|segments|否|该属性指定构建这个管所用的分段数.路径越长,指定的分段数应该越多|
|radius|否|该属性指定管的半径,默认为1|
|radiusSegments|否|该属性指定管圆周的分段数.默认值为8.分段数越多,管越圆.|
|closed|否|该属性指定是否管头尾会连起来.默认为false|


## SVG extrude (SVG 拉伸)

在使用ShapeGeometry时,使用SVG的方式和自己绘制图形的方式基本一致.
本例我们就使用SVG文件的蝙蝠侠来创建一个三维图形

import { Scene as SceneC } from './05c-extrude-svg.jsx';

<SceneC />

<br/>

看下原始SVG文件

```xml
<svg version="1.0" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="1152px" height="1152px" xml:space="preserve">
    <g>
        <path  id="batman-path" style="fill:rgb(0,0,0);" d="M 261.135 114.535 C 254.906 116.662 247.491 118.825 244.659 119.344 C 229.433 122.131 177.907 142.565 151.973 156.101 C 111.417 177.269 78.9808 203.399 49.2992 238.815 C 41.0479 248.66 26.5057 277.248 21.0148 294.418 C 14.873 313.624 15.3588 357.341 21.9304 376.806 C 29.244 398.469 39.6107 416.935 52.0865 430.524 C 58.2431 437.23 63.3085 443.321 63.3431 444.06 C 63.4748 446.883 102.278 479.707 120.51 492.418 C 131.003 499.734 148.168 509.93 158.654 515.075 C 169.139 520.22 179.431 525.34 181.524 526.454 C 187.725 529.754 187.304 527.547 179.472 515.713 C 164.806 493.553 158.448 464.659 164.322 446.861 C 169.457 431.303 192.013 421.501 214.324 425.132 C 234.042 428.341 252.142 439.186 270.958 459.064 C 286.677 475.67 292.133 482.967 295.31 491.634 C 297.466 497.514 298.948 495.91 304.862 481.293 C 313.673 459.519 329.808 445.735 346.35 445.851 C 367.654 446 399.679 478.239 412.801 512.745 C 414.093 516.144 416.593 522.632 418.355 527.163 C 420.118 531.695 423.604 542.319 426.103 550.773 C 430.848 566.832 432.355 566.851 434.872 550.88 C 436.395 541.215 451.403 502.522 455.655 497.298 C 457.038 495.599 460.63 489.896 463.636 484.625 C 471.696 470.498 492.318 452.688 505.387 448.568 C 514.602 445.663 517.533 445.549 525.51 447.782 C 539.676 451.749 553.43 467.773 560.706 488.788 L 563.242 496.114 L 567.096 490.012 C 577.709 473.208 593.665 453.899 602.47 447.206 C 607.884 443.09 613.378 438.825 614.679 437.729 C 615.98 436.632 622.927 433.259 630.118 430.233 C 655.159 419.693 681.195 423.407 693.273 439.241 C 697.957 445.382 698.932 448.971 699.538 462.294 C 700.174 476.284 699.51 479.864 693.686 493.854 C 690.073 502.533 684.912 512.883 682.217 516.854 C 679.523 520.825 678.172 524.074 679.215 524.074 C 681.932 524.074 718.787 504.481 732.525 495.734 C 760.018 478.228 788.909 452.599 803.9 432.418 C 807.266 427.886 810.569 423.715 811.239 423.149 C 814.498 420.395 828.253 393.099 833.17 379.627 C 838.223 365.782 838.713 361.822 838.741 334.582 C 838.776 300.425 836.431 291.124 820.154 260.873 C 810.649 243.207 807.498 239.005 788.417 218.543 C 751.511 178.968 688.147 142.549 621.582 122.654 C 581.7 110.734 580.388 110.465 580.388 114.195 C 580.388 115.328 581.302 116.255 582.418 116.255 C 584.279 116.255 587.705 122.106 603.399 152.085 C 613.977 172.29 618.077 189.427 618.264 214.21 C 618.42 234.928 617.88 238.368 612.285 252.269 C 604.327 272.04 590.066 286.889 572.829 293.352 C 558.526 298.714 549.193 297.86 535.704 289.955 C 526.777 284.723 512.304 267.644 509.816 259.404 C 509.132 257.138 507.129 251.358 505.366 246.558 C 503.602 241.759 501.646 231.564 501.018 223.902 C 500.39 216.24 498.491 198.402 496.797 184.261 C 495.104 170.121 493.307 152.047 492.803 144.097 C 492.299 136.147 491.292 125.625 490.565 120.715 L 489.242 111.787 L 483.323 118.267 C 480.067 121.832 477.404 125.618 477.404 126.681 C 477.404 127.744 476.603 128.613 475.624 128.613 C 474.645 128.613 471.275 132.321 468.135 136.852 L 462.426 145.091 L 431.038 145.091 L 399.65 145.091 L 386.811 128.494 C 379.749 119.365 373.509 112.36 372.943 112.926 C 372.377 113.491 371.57 118.875 371.15 124.888 C 370.73 130.902 368.94 147.744 367.172 162.315 C 365.405 176.887 363.523 195.424 362.99 203.509 C 360.283 244.622 352.784 266.044 335.323 282.544 C 326.456 290.923 312.488 297.497 303.508 297.518 C 294.864 297.539 278.732 290.063 269.473 281.748 C 246.952 261.521 238.846 229.614 245.481 187.314 C 247.894 171.928 266.562 131.612 275.927 121.56 C 277.987 119.348 279.673 116.786 279.673 115.867 C 279.673 114.947 279.905 113.593 280.188 112.856 C 281.28 110.017 271.977 110.837 261.136 114.536 L 261.135 114.535 "/>
    </g>
</svg>
```

上面代码中显式的是一组绘图指令.例如: `C 277.987119.348279.673116.786279.673115.867` 就是告诉浏览器绘制一个贝塞尔曲线, 而 `L 489.242111.787` 就是告诉浏览器绘制一条直线.

我们可以使用SVGLoader(这个在后面会介绍到)来加载SVG文件,

:::info
SVG的含义是可缩放矢量图（Scalable Vector Graphics）。它基于XML的标准，用来在网页上创建二维矢量图。
该标准是一个所有现代浏览器都支持的开放标准。但是，直接使用SVG，通过JavaScript来操作它并不直观。
幸运的是，有几个开源JavaScript库使得使用SVG更简单。
Paper.js、Snap.js、D3.js和Raphael.js是其中最好的几个。
:::

下面代码展示了如何加载SVG文件并将达转化成`THREE.ExtrudeGeometry`

```jsx
function generateGeometry() {

    const geometry = new THREE.ExtrudeGeometry(drawShape(),data);
    geometry.applyMatrix4(new THREE.Matrix4().makeTranslation(-390, -74, 0));
    updateGroupGeometry(mesh,geometry);
    mesh.scale.x = 0.05;
    mesh.scale.y = 0.05;

    mesh.rotation.z = Math.PI;
    mesh.rotation.x = -1.1;
}

function drawShape() {

    const loader = new SVGLoader();
    var data = loader.parse(batman);
    console.log(data);
    const paths = data.paths;

    for ( let i = 0; i < paths.length; i ++ ) {
        const path = paths[ i ];

        const shapes = SVGLoader.createShapes( path );

        for ( let j = 0; j < shapes.length; j ++ ) {
            const shape = shapes[ j ];
            return shape;
        }
    }

}
```
这段代码中我们使用`SVGLoader`加载svg字符串,并将它解析成 `THREE.ShapePath` 再通过 `createShape` 函数将shapePath转化成 `ShapeGeometry` 
最终将shape传入到`THREE.ExtrudGeometry`中.